package com.thinvent.recommend.service;

import com.thinvent.recommend.manager.dto.RecommendedDocDTO;

import java.util.List;

/**
 * 推荐服务：对外暴露基于用户行为的推荐接口
 */
public interface RecommendationService {

    /**
     * 根据用户 ID 返回推荐文档列表
     *
     * @param userId 用户业务 ID
     * @return 推荐的文档列表，每条包含文档 ID 和相似度得分
     */
    List<RecommendedDocDTO> recommendByUser(String userId);

    /**
     * 基于用户岗位关键词的推荐
     */
    List<RecommendedDocDTO> recommendByPosition(String userId);

    /**
     * 根据用户所在部门的历史操作（编辑/预览/下载）推荐文档
     */
    List<RecommendedDocDTO> recommendByDeptHistory(String userId);
}
